Date picker - month names

Description

Specify the month names to be shown when the pop-up date picker is used. Enter a comma separated list.

Discussion

TIP: You can also set the month names in this special session variable: session.__protected_datePickerMonthNames.

Changing Month Names

Changing the month names is easy, just write the new month names in place of the old names, making sure to delimited months using a comma. For example, you may replace the following

images/dpm.png

with a set of months in French

images/dpm2.png

For any calendar control used in the component the month names should change automatically.

images/dpm3.png

This approach presents an easy fix if you want to quickly change how the months are spelled. However, if you want to use more complex characters or switch out multiple languages in you application, you may want to consider using <cultureMonthNames> or text dictionary tags.

Automatically Setting Month Names Based on the User's Locale

You can specify that the month names should be dynamically computed based on the user's locale by setting the Date picker - month names property to <cultureDayNames>. This makes it easier to build applications that seamlessly adapt based on the user's locale setting.

images/cultureMonthNames.png

Creating Month Names in Multiple Languages Using Text Dictionary Tags

The Date picker - month names property can be tagged with Text dictionary tags. Each month can then be written in multiple languages and displayed in the calendar whenever a given language is active. When using this approach, each month is tagged separately.

<a5:t>January</a5:t>,<a5:t>February</a5:t>,<a5:t>March</a5:t>,<a5:t>April</a5:t>,
<a5:t>May</a5:t>,<a5:t>June</a5:t>,<a5:t>July</a5:t>,<a5:t>August</a5:t>,<a5:t>September</a5:t>,
<a5:t>October</a5:t>,<a5:t>November</a5:t>,<a5:t>December</a5:t>

The quickest way to insert text dictionary tags is using the Internationalization Helper Utilities.

images/dpm5.png

The Internationalization Helper Utilities dialog can be used to quickly add text dictionary tags (or language tags) to all text in the UX component. Click the Select All button to generate a script to add text dictionary tags for all the text within the component. Then click the Execute Code button to add the tags.

images/dpm6.png

When you open the UX Properties page, the text will be tagged

images/dpm7.png

After being tagged, multiple language definitions can be added for each month using the Text dictionary tags property.

images/dpm4.png

In order to use Text Dictionary tags, you must first configure a SQL table where the translations can be stored. For a detailed explanation on how to do this see the page on Text dictionary tags.

images/dpm8.png
A calendar control using text dictionary tags

See Also